home *** CD-ROM | disk | FTP | other *** search
/ Multimedia Toolkit 2 / Multimedia Toolkit 2.iso / utilities / tm / docs / trashmaster.doc < prev    next >
Encoding:
Text File  |  1993-04-29  |  6.7 KB  |  173 lines
  1.  
  2.  
  3. *
  4.  
  5.                              TRASHMASTER V1.4
  6.  
  7.                The ultimate in byte disposal for the Amiga.
  8.  
  9.           Copyright (c) 1993 By Aric R Caley and Greywire designs
  10.  
  11.                                28 April 1993
  12.  
  13.  
  14. Who, what, where, when, why
  15. ****************************
  16.  
  17. WHO
  18. ---
  19.  
  20.    Written by Aric R Caley, AKA Dances V2.0, Dances With Coyotes, Major, Mr
  21. Coyote, and other handles/nicknames.  :) See the readme file if you wish to
  22. contact me.
  23.  
  24. WHAT
  25. ----
  26.  
  27.    See the Readme file!
  28.  
  29. WHERE
  30. -----
  31.  
  32.    Best place is in your WBStartup drawer!
  33.  
  34. WHEN
  35. ----
  36.  
  37.    The current version, 1.4, was released on 28 April 1993.  The first
  38. public release of Trashmaster was Jan 23 1992.
  39.  
  40. WHY
  41. ---
  42.  
  43.    I had always wanted to write something like this but until now, I couldnt
  44. do it.  Not that it was particularly easy to do, even on 2.0.
  45.  
  46.  
  47. How I did it
  48. *************
  49.  
  50.    The main problem is with getting finicky old Workbench to stay "in sync"
  51. with the filing system..  IE, removing its icons when a file is deleted.
  52. Thanks to a new function called DeleteDiskObject(), it's possible to get
  53. workbench to remove an icon.  Unfortunately Workbench still is kinda
  54. brain-dead...  when you have it display ALL files, it spontaneously creates
  55. icons in memory for files that dont have them...  which results in
  56. DeleteDiskObject not working (no file on disk) and Workbench not removeing
  57. the icon.  The only solution I could come up with is to PutDiskObject() and
  58. then delete this icon, which works more or less pretty well.  There are
  59. still, however, problems.  Workbench, it seems, will "lock" a directory if
  60. its window is open on the Workbench screen.  This means I cant delete it
  61. until it's closed..  not too big a deal, since when you delete the icon the
  62. window closes automaticly.  But what if something ELSE has that directory
  63. "locked"?  Then I couldnt delete it after all...  that means I need to put
  64. the icon back!  heheh.  But I think I've come up with a good solution.
  65.  
  66.    Another problem is that there's no way to find out where the AppIcon is,
  67. within the WorkBench window -- so there is no way to implement a snapshot
  68. option within your application (of course, the root problem is that
  69. Workbench doesn't provide any way to "hook" into the Workbench operations
  70. like snapshot, info, etc.  See below for my solution to this).
  71.  
  72.    This seems like a good place to voice some opinions on Workbench 2.0, and
  73. what I'd like to see in the future.
  74.  
  75.  
  76. Icon / Workbench wish list
  77. ***************************
  78.  
  79.    * DiskObjects should be a BOOPSI class.
  80.  
  81.         * A BOOPSI class would have methods for all the normal Workbench
  82.           operations; like info, double click, delete, snapshot, copy/move,
  83.           etc.  That way, an AppIcon could give an "about" requester with
  84.           the info menu function, and behave in every way just like a
  85.           regular icon.  Say you had an icon for a network machine...  info
  86.           could put up a requester saying what the node's name was, CPU
  87.           class, whether it was Ethernet or serial, etc.  neat huh?  A
  88.           Drawer could open it's own type of list window..  perhaps one
  89.           with a "tree" display.  You could replace the standard operation
  90.           with new ones (via hooks into the DiskObject class).  This makes
  91.           Workbench extremely flexible and extendable and would allow third
  92.           party people to add tons of functionality to Workbench (I should
  93.           be able to make Workbench as powerfull as DiskMaster or DirOpus!)
  94.  
  95.         * This BOOPSI icon would be able to have more than just a bitmap
  96.           image; like actual structured drawing objects.  Of course, this
  97.           introduces the problem of how to store objects on disk..  which I
  98.           myself am working on.
  99.  
  100.         * ANY application would now be able to use icons easily (they dont
  101.           have to have anything to do with Workbench).  You could even drag
  102.           icons FROM an application TO a Workbench window to save a file.
  103.  
  104.    * Clipboard support, with a "view clipboard" window.
  105.  
  106.    * Definable default tools for projects, with file recognition so it knows
  107.      what tool to run (in case there's no icon or the normal tool cant be
  108.      found).  And how about a small database that contains application
  109.      names and then a path to where it is?  Actualy, I guess you could have
  110.      a "Applications" directory, with icons that are linked to whereever
  111.      the app is -- and Workbench would check here first for tools.
  112.  
  113.    * "Left out" icons could be done in the same way, so that the app's icon
  114.      is still visible in it's Drawer, and so that Snapshoting the left out
  115.      icon doesn't ruin it's original coordinates.
  116.  
  117.    * Something needs to be done about the list windows..  they are slow and
  118.      clumsy, and are missing what I think is a great feature:  a "Tree"
  119.      mode.
  120.  
  121.    * Better tracking of when other apps change/add/delete files.
  122.  
  123.    OK, I'll step down off my soapbox now!
  124.  
  125.  
  126. Using Trashmaster
  127. ******************
  128.  
  129.    To run Trashmaster, simply double click its icon, or run it from a CLI
  130. (it will detach from the CLI of course).  Obviously, Workbench must be
  131. running (and will be, unless you were naughty and modified your
  132. startup-sequence). Trashmaster will open an icon on the Workbench screen;
  133. this icon will look the same as the icon you ran Trashmaster from.  If you
  134. want to change it, you can, by modifieing the Tooltypes in Trashmaster's
  135. icon (see below about the Tooltypes available).  BTW, the icon is supposed
  136. to look like a "black hole"...
  137.  
  138. Tooltypes.
  139. ----------
  140.  
  141.    There are 3 Tooltypes you can add/modify:
  142.  
  143.   1. X=## -- This is the X coordinate of the icon.  A -1 will tell
  144.      workbench to find a suitable place for the icon.
  145.  
  146.   2. Y=## -- This is the Y cooridnate of the icon.  A -1 will tell
  147.      workbench to find a suitable place for the icon.
  148.  
  149.   3. ICON=<name> -- This is the name of a custom icon to be used instead of
  150.      the default icon (the default being Trashmaster's icon)
  151.  
  152. Usage
  153. -----
  154.  
  155.    To use Trashmaster, simply drag files and drop them on the icon.  A
  156. requester will come up, similar to Workbench's Delete confirmation
  157. requester.  If you really want to delete the file(s) or dir(s), click
  158. "OK"..  if not, hit "CANCEL".  Remember, once you hit "OK", the files are
  159. deleted..  they're GONE!  For reals.  Not like the Trashcan.
  160.  
  161.    One difference from the Workbench Delete, is the extra option for
  162. Interactive deletion.  With interactive delete, you will get a confirmation
  163. requester for each file you dropped into Trashmaster.  For each file, you
  164. can choose to either delete it, delete all the rest of the files
  165. non-interactively, skip this file, or abort completely.
  166.  
  167.    To quit Trashmaster (which you dont really want to do, do you?  :),
  168. double click the icon.
  169.  
  170.    If you want Trashmaster started automaticly (you DO, dont you?), place it
  171. into the "WBStartup" drawer on your boot disk.
  172.  
  173.